package com.service;

import com.bean.BookCategory;
import com.utils.PageInfo;
import java.util.List;

public interface BookCategoryService {

    /**
     * 根据分类 ID 获取书籍分类信息
     * @param categoryId 分类 ID
     * @return 对应的书籍分类信息，如果未找到则返回 null
     */
    BookCategory getBookCategoryById(Integer categoryId);

    /**
     * 获取所有书籍分类信息
     * @return 包含所有书籍分类信息的列表
     */
    List<BookCategory> getAllBookCategories();

    /**
     * 插入新的书籍分类信息
     * @param bookCategory 要插入的书籍分类信息对象
     * @return 插入操作是否成功，成功返回 true，失败返回 false
     */
    boolean insertBookCategory(BookCategory bookCategory);

    /**
     * 根据分类 ID 更新书籍分类信息
     * @param bookCategory 包含要更新信息的书籍分类对象，categoryId 用于定位要更新的记录
     * @return 更新操作是否成功，成功返回 true，失败返回 false
     */
    boolean updateBookCategory(BookCategory bookCategory);

    /**
     * 根据分类 ID 删除书籍分类信息
     * @param categoryId 要删除的分类 ID
     * @return 删除操作是否成功，成功返回 true，失败返回 false
     */
    boolean deleteBookCategoryById(Integer categoryId);

    /**
     * 分页模糊查询书籍分类信息
     * @param keyword 模糊查询的关键字，可匹配分类名称
     * @param pageNum 当前页码
     * @param pageSize 每页显示的记录数
     * @return 包含分页信息的书籍分类信息列表
     */
    PageInfo<BookCategory> getBookCategoriesByKeyword(String keyword, int pageNum, int pageSize);
}